<!DOCTYPE html>
<html>
<head>
<title>Weiran ECMAScript Applications Framework</title>
<link rel=stylesheet type=text/css href=./style.css>
</head>

<body>

<div class=leftbar>
    <h1>Weiran</h1>
    <p>ECMAScript<br />Applications Framework</p>
    <p>Version: 1.2</p>
    <ul>
	<li><a href=Weiran.html>Weiran</a></li>
	<li><a href=Weiran.Array.html>Weiran.Array</a></li>
	<li><a href=Weiran.Buffer.html>Weiran.Buffer</a></li>
	<li><a href=Weiran.Class.html>Weiran.Class</a></li>
	<li><a href=Weiran.Date.html>Weiran.Date</a></li>
	<li><a href=Weiran.DB.html>Weiran.DB</a></li>
	<li><a href=Weiran.Event.html>Weiran.Event</a></li>
	<li><a href=Weiran.Events.html>Weiran.Events</a></li>
	<li><a href=Weiran.Function.html>Weiran.Function</a></li>
	<li>Weiran.JSON<ul>
	    <li><a href=#Weiran.JSON.parse>Weiran.JSON.parse</a></li>
	    <li><a href=#Weiran.JSON.stringify>Weiran.JSON.stringify</a></li>
	</ul></li>
	<li><a href=Weiran.Lang.html>Weiran.Lang</a></li>
	<li><a href=Weiran.Number.html>Weiran.Number</a></li>
	<li><a href=Weiran.String.html>Weiran.String</a></li>
	<li><a href=Weiran.GRUB.html>GRUB Mechanism</a></li>
    </ul>
    <p>
        Copyright &copy; All<span>i</span>dylls<br />
        2011 - 2012
    </p>
</div>

<div class=content>

<div class=reftitle>Weiran.JSON</div>
<p>Sub namespace contains convenience functions for JSON manipulation.</p>

<a name=Weiran.JSON.parse></a>
<h3><code>Weiran.JSON.parse(text, reviver)</code></h3>
<p><b>Static method</b></p>
<p>
    <b>Parameters:</b><br />
    <span class=parameters>text</span> - <code>string</code>, text of stringified object<br />
    <span class=parameters>reviver</span> - <code>function</code>, optional filter function
</p>
<p><b>Returns: </b><code>object</code></p>
<p>This method parses a JSON text to produce an object or array. It can throw a SyntaxError exception.</p>
<p>The optional reviver parameter is a function that can filter and
            transform the results. It receives each of the keys and values,
            and its return value is used instead of the original value.
            If it returns what it received, then the structure is not modified.
            If it returns undefined then the member is deleted.</p>
<p>Example:</p>
<p><code><pre>
    // Parse the text. Values that look like ISO date strings will be converted to Date objects.

    myData = JSON.parse(text, function (key, value) {
        var a;
        if (typeof value === 'string') {
            a = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2}(?:\.\d*)?)Z$/.exec(value);
            if (a) {
                return new Date(Date.UTC(+a[1], +a[2] - 1, +a[3], +a[4], +a[5], +a[6]));
            }
        }
        return value;
    });

    myData = JSON.parse('["Date(09/09/2001)"]', function (key, value) {
        var d;
        if (typeof value === 'string' && value.slice(0, 5) === 'Date(' && value.slice(-1) === ')') {
            d = new Date(value.slice(5, -1));
            if (d) {
                return d;
            }
        }
        return value;
    });</pre></code></p>

<a name=Weiran.JSON.stringify></a>
<h3><code>Weiran.JSON.stringify(value, replacer, space)</code></h3>
<p><b>Static method</b></p>
<p>
    <b>Parameters:</b><br />
    <span class=parameters>value</span> - any JavaScript value, usually an object or array<br />
    <span class=parameters>replacer</span> - optional function or an array of strings<br />
    <span class=parameters>replacer</span> - an optional parameter that specifies the indentation of nested structures
</p>
<p><b>Returns: </b><code>string</code></p>
<p>This method produces a JSON text from a JavaScript value.</p>
<p>When an object value is found, if the object contains a toJSON
            method, its toJSON method will be called and the result will be
            stringified. A toJSON method does not serialize: it returns the
            value represented by the name/value pair that should be serialized,
            or undefined if nothing should be serialized. The toJSON method
            will be passed the key associated with the value, and this will be
            bound to the value</p>
<p>For example, this would serialize Dates as ISO strings.</p>
<p><code><pre>
    Date.prototype.toJSON = function (key) {
        function f(n) {
            // Format integers to have at least two digits.
            return n &lt; 10 ? '0' + n : n;
        }
        
        return this.getUTCFullYear()   + '-' +
             f(this.getUTCMonth() + 1) + '-' +
             f(this.getUTCDate())      + 'T' +
             f(this.getUTCHours())     + ':' +
             f(this.getUTCMinutes())   + ':' +
             f(this.getUTCSeconds())   + 'Z';
    };</pre></code></p>
<p>You can provide an optional replacer method. It will be passed the
            key and value of each member, with this bound to the containing
            object. The value that is returned from your method will be
            serialized. If your method returns undefined, then the member will
            be excluded from the serialization.</p>
<p>If the replacer parameter is an array of strings, then it will be
            used to select the members to be serialized. It filters the results
            such that only members with keys listed in the replacer array are
            stringified.</p>
<p>Values that do not have JSON representations, such as undefined or
            functions, will not be serialized. Such values in objects will be
            dropped; in arrays they will be replaced with null. You can use
            a replacer function to replace those with JSON values.
            <code>Weiran.JSON.stringify(undefined)</code> returns <code>undefined</code>.</p>
<p>The optional space parameter produces a stringification of the
            value that is filled with line breaks and indentation to make it
            easier to read.</p>
<p>If the space parameter is a non-empty string, then that string will
            be used for indentation. If the space parameter is a number, then
            the indentation will be that many spaces.</p>
<p>Example:</p>
<p><code><pre>
    text = JSON.stringify(['e', {pluribus: 'unum'}]);
    // text is '["e",{"pluribus":"unum"}]'
    
    text = JSON.stringify(['e', {pluribus: 'unum'}], null, '\t');
    // text is '[\n\t"e",\n\t{\n\t\t"pluribus": "unum"\n\t}\n]'

    text = JSON.stringify([new Date()], function (key, value) {
        return this[key] instanceof Date ? 'Date(' + this[key] + ')' : value;
    });
    // text is '["Date(---current time---)"]'</pre></code></p>
    
</div>

</body>
</html>
